home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / programr / fileutil.zip / README < prev    next >
Text File  |  1990-09-07  |  4KB  |  96 lines
  1. This is the GNU file manipulation utilities package.  Most of these
  2. programs have significant advantages over their Unix counterparts,
  3. such as greater speed, additional options, and fewer arbitrary limits.
  4.  
  5. Summary of changes by release:
  6.  
  7. 1.1.  Some bug fixes, enhancements, and changes for POSIX conformance,
  8. including adding two programs invented by the POSIX committee (create
  9. and mkfifo).
  10.  
  11. 1.2.  An important bug fix for cp on systems that do not have the
  12. ftruncate system call.
  13.  
  14. 1.3.  Added tac and install programs, more bug fixes and POSIX and
  15. ANSI C changes, support for 16 bit machines, and backup file creation
  16. options.
  17.  
  18. 1.4.  Added simple roff -man documentation, cut, paste, and touch
  19. programs, changes to accomodate a new draft of POSIX.2 including
  20. removal of the create program, more bug fixes, and some new options.
  21.  
  22. The fileutils are intended to be POSIX compliant (with BSD and other
  23. extensions), like the rest of the GNU system.  They are not all quite
  24. there yet; however, the POSIX shell and utilities standard (1003.2)
  25. has not been finalized, either.  They presently don't support
  26. internationalization features, since none of the C libraries that I
  27. have access to do.  (The GNU C library will, but isn't finished.)
  28.  
  29. The comprehensive Texinfo documentation for these programs is not
  30. finished yet, and needs to be rewritten.  In the interim, the skeletal
  31. man pages provided with this distribution will have to serve.
  32.  
  33. The ls, dir, and vdir commands are all separate executables instead of
  34. one program that checks argv[0] because people often rename these
  35. programs to things like gls, gnuls, l, etc., and renaming a program
  36. file shouldn't affect how it operates, so that people can get the
  37. behavior they want with whatever name they want.
  38.  
  39. The GNU ls with the -s option, and at the top of long listings of
  40. directories, reports file sizes in units of 512 bytes by default, as
  41. required by POSIX.  The GNU du does the same thing, also for POSIX.
  42. The GNU ls and du both have a -k option to make them report sizes in
  43. kilobytes instead.
  44.  
  45. The GNU tail command has no -r option (print in reverse).  Reversing a
  46. file is really a different job from printing the end of a file; the
  47. BSD tail can get away with kludging it in because of its limited size
  48. buffer.  A more versatile way than tail -r to reverse files is the
  49. `tac' command included in this package.
  50.  
  51. The GNU rm, like every other program that uses getopt, lets you use the
  52. "--" option to indicate that all following arguments are non-options.
  53. To remove a file called "-f" in the current directory, you could either
  54.     rm -- -f
  55. or
  56.     rm ./-f
  57. The Unix rm's use of "-" for this purpose predates the development of
  58. the getopt standard syntax.
  59.  
  60. The GNU cp, mv, and ln commands can make backups of files that they
  61. are about to overwrite or remove.  They make backups only when the -b
  62. (+backup) option is given.
  63.  
  64. The type of backups made can be set with the VERSION_CONTROL
  65. environment variable, which can be overridden by the -V
  66. (+version-control) option.  If VERSION_CONTROL is not set and -V
  67. (+version-control) is not given, the default backup type is
  68. `existing'.
  69.  
  70. The value of VERSION_CONTROL and the argument to -V (+version-control)
  71. is like GNU Emacs' `version-control' variable; it also accepts
  72. synonyms that are more descriptive.  The valid values are (unique
  73. abbreviations are accepted):
  74.  
  75. t or numbered        Always make numbered backups.
  76. nil or existing        Make numbered backups of files that already
  77.             have them, simple backups of the others.
  78. never or simple        Always make simple backups.
  79.  
  80. The suffix used for making simple backup files can be set with the
  81. SIMPLE_BACKUP_SUFFIX environment variable, which can be overridden by
  82. the -S (+suffix) option.  If neither of those is given, the default is
  83. `~', as it is in Emacs.
  84.  
  85. Backup file names will end up being the same as the original file
  86. names for files that are at the system's filename length limit; when
  87. that happens, the new file will silently replace the backup file that
  88. was just made.  This happens with GNU Emacs, also.  I am not aware of
  89. a clean, simple solution to this problem.
  90.  
  91. Special thanks to Jim Meyering, Brian Matthews, and Bruce Evans for
  92. help with debugging and porting these programs.
  93.  
  94. Suggestions and bug reports for these programs should be mailed to
  95. bug-gnu-utils@prep.ai.mit.edu.
  96.